Skip to content

feat(eve): agent sources - establish the canonical source graph - #2407

Closed
AndrewBarba wants to merge 1 commit into
mainfrom
barba/source-neutral-module-bindings
Closed

feat(eve): agent sources - establish the canonical source graph#2407
AndrewBarba wants to merge 1 commit into
mainfrom
barba/source-neutral-module-bindings

Conversation

@AndrewBarba

@AndrewBarba AndrewBarba commented Aug 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Related to #2347 and implements the approved design in #2404. This single, unstacked PR replaces framework catalogs, extension-specific merges, fallbacks, and inspection reconstruction with one canonical agent source graph: every executable candidate receives an explicit binding, winners are selected before normalization, and the resulting manifest and compiled plans are the only runtime authority. Framework defaults—including agent config, ordinary tools, sandbox, home, health, and framework channels—are now first-class eve primitives, while genuinely native behavior is limited to exhaustive kernel and host inventories.

The change is intentionally breaking before 1.0: agent-info moves to truthful v3 semantics, extension contracts advance, and removed paths have no compatibility fallback. The in-memory compiler now uses the same source graph and binding lifecycle as disk compilation, and deterministic e2e coverage proves ownership, replacement, routes, capabilities, and durable execution. Review should focus on source precedence, binding-only hydration, the closed native inventories, and the deletion guards that prevent any parallel system from returning.

Validation

The exact consolidated tree passes formatting, linting (with one unchanged Teams optional-chaining warning), workspace type checking, the 17 invariant guards, documentation validation across 82 pages and 360 code blocks, and the package build. Local coverage passes 7,525 unit tests with one skip, 694 integration tests, and 453 scenario tests with 15 environment-gated skips. An actual production build against @workflow/world-postgres succeeds, and the Weather fixture bundle is 19,403,985 bytes—6.53% over main and below the 10% budget. All ten credential-free TUI smoke scripts pass; the five live-model scripts require AI Gateway credentials locally and remain for the GitHub e2e phase.

Checklist

  • This change was requested or approved by a maintainer
  • I ran the relevant checks from CONTRIBUTING.md
  • I added tests and documentation where relevant
  • I added a changeset if this touches the published eve package
  • DCO sign-off passes for every commit (git commit --signoff)

Diff size

Docs — 18 files · +208 / -34

Public docs and one consolidated minor changeset describe the canonical source model, first-class defaults, inspection v3, and the resulting breaking behavior.

Implementation — 458 files · +23571 / -9510

This is the deliberate atomic replacement boundary. Compiler contracts, generated artifacts, primitive definitions, runtime consumers, routes, native plans, and invariant guards move together so no intermediate or legacy authority remains usable.

Tests — 327 files · +25618 / -3926

Coverage follows every replaced boundary across unit, integration, scenario, fixture, contract, TUI, and deterministic e2e layers. The breadth is necessary because the refactor changes the shared compiled graph consumed by nearly every framework surface, rather than one isolated feature path.

@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eve-docs Ready Ready Preview, v0 Aug 24, 2026 5:42pm
eve-docs-4759 Error Error v0 Aug 24, 2026 5:42pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
eve-pkg Skipped Skipped v0 Aug 24, 2026 5:42pm

@github-actions

github-actions Bot commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Bundle + Package Summary: apps/fixtures/weather-agent

Key takeaways

  • Package delta: install footprint 75.02 MB -> 75.53 MB (+509.7 kB ⚠️).
  • Runtime delta: function payloads 18.21 MB -> 19.40 MB (+1.19 MB ⚠️); 2 changed payloads.

Delta vs main (eb35ba7)

Area Metric Baseline Current Delta
Package Packed tarball 8.19 MB 8.29 MB +96.2 kB ⚠️
Package Unpacked publish size 30.83 MB 31.34 MB +509.7 kB ⚠️
Package Installed footprint 75.02 MB 75.53 MB +509.7 kB ⚠️
Package Published files 3410 3574 +164
Package Installed files 7124 7288 +164
Package Installed package instances 35 35 0
Package Distinct installed package names 34 34 0
Package Installed dependency edges 53 53 0
Package Installed optional peer edges 47 47 0
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 18.21 MB 19.40 MB +1.19 MB ⚠️
Runtime Public routes 16 16 0
Changed function payloads vs main (eb35ba7) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 9.11 MB 9.70 MB +594.8 kB ⚠️ none
functions/.well-known/workflow/v1/flow.func changed 9.11 MB 9.70 MB +594.8 kB ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 113.43 MB 113.94 MB +509.7 kB ⚠️
Installed packages 121 121 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 45.39 MB 45.90 MB +509.7 kB ⚠️
devDependency package bytes 5.04 MB 5.04 MB 0 B ➖
Build Metadata
  • Preset: vercel
  • Nitro: nitro@3.0.260610-beta
  • Output directory: apps/fixtures/weather-agent/.vercel/output
  • Build metadata timestamp: 2026-08-24T17:42:33.691Z
  • Route aliases: 16 public, 1 internal (17 total aliases)
  • Vercel routes in config: 19
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.44.3
  • Package directory: packages/eve
  • Tarball: 8.29 MB (eve-0.44.3.tgz)
  • Unpacked payload: 31.34 MB across 3574 published files
  • Installed footprint: 75.53 MB across 7288 installed files
  • Installed root package: 29.99 MB
  • Installed dependencies: 45.55 MB
  • Installed package instances: 35
  • Distinct installed package names: 34
  • Installed dependency edges: 53
  • Installed optional peer edges: 47
  • Runtime dependencies: 2
  • Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.
Graph metrics read only package.json files in package directories directly beneath a node_modules boundary, including nested boundaries. Each directory is one package instance; distinct names come from those manifests. Dependency edges count each unique name in dependencies or optionalDependencies per instance; optional peer edges count peerDependencies marked optional.

Heavy installed dependencies

  • eve: 29.99 MB (39.7%)
  • @rolldown/binding-linux-x64-gnu: 19.91 MB (26.4%)
  • ai: 6.75 MB (8.9%)
  • zod: 5.07 MB (6.7%)
  • undici: 3.50 MB (4.6%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [##############..........] 9.76 MB 31.1%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [####....................] 2.44 MB 7.8%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [##......................] 1.51 MB 4.8%
🟡 dist/src/compiled/_chunks/workflow/undici-Dzn... [#.......................] 512.7 kB 1.6%
🟡 dist/src/compiled/_chunks/node/undici-CUIybhQ... [#.......................] 508.8 kB 1.6%
🔴 Other published files                            [########################] 16.61 MB 53.0%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 29.99 MB 39.7%
🔴 @rolldown/binding-linux-x64-gnu [################........] 19.91 MB 26.4%
🔴 ai                              [#####...................] 6.75 MB 8.9%
🔴 zod                             [####....................] 5.07 MB 6.7%
🟠 undici                          [###.....................] 3.50 MB 4.6%
🟠 nitro                           [##......................] 2.41 MB 3.2%
🔴 Other installed packages        [######..................] 7.90 MB 10.5%
Runtime dependencies (2)
Package Range Notes
nitro 3.0.260610-beta
undici 8.9.0
Peer dependencies (5)
Package Range Notes
@opentelemetry/api ^1.0.0 optional peer
ai catalog:
braintrust ^3.0.0 optional peer
just-bash ^3.1.0 optional peer
microsandbox ^0.5.0 optional peer
eve init install drill-down

eve init install details

  • Command: eve init my-agent
  • Package manager: npm
  • Installed footprint: 113.94 MB across 9164 installed files
  • Installed packages: 121 total (115 transitive-only)
  • dependencies: 4 direct packages totaling 45.90 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 63.00 MB

Installed footprint is measured from an isolated temporary eve init my-agent using the current packed eve tarball.

Heavy installed dependencies

  • eve: 29.99 MB (26.3%)
  • @typescript/typescript-linux-x64: 27.95 MB (24.5%)
  • @rolldown/binding-linux-x64-gnu: 19.91 MB (17.5%)
  • zod: 9.02 MB (7.9%)
  • ai: 6.75 MB (5.9%)
Installed footprint breakdown
Installed package size
🔴 eve                              [########################] 29.99 MB 26.3%
🔴 @typescript/typescript-linux-x64 [######################..] 27.95 MB 24.5%
🔴 @rolldown/binding-linux-x64-gnu  [################........] 19.91 MB 17.5%
🔴 zod                              [#######.................] 9.02 MB 7.9%
🔴 ai                               [#####...................] 6.75 MB 5.9%
🟠 undici                           [###.....................] 3.50 MB 3.1%
🔴 Other installed packages         [#############...........] 16.82 MB 14.8%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.3 141.0 kB 0.1%
ai ^7.0.58 6.75 MB 5.9%
eve file:eve-0.44.3.tgz 29.99 MB 26.3%
zod 4.4.3 9.02 MB 7.9%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.2%
typescript 7.0.2 2.50 MB 2.2%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 9.70 MB 50.0%
🔴 functions/__server.func                         [########################] 9.70 MB 50.0%

Top Function Payloads

🟠 functions/.well-known/workflow/v1/flow.func • 1 public route • 9.70 MB
Metric Value
Public routes /.well-known/workflow/v1/flow
Runtime nodejs24.x
Handler index.mjs
Payload 9.70 MB
Function files 9.70 MB across 133 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 1.59 MB (16.4%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                   [########................] 1.59 MB 16.4%
🟡 _libs/undici.mjs            [#####...................] 980.5 kB 10.1%
🟡 _chunks/sandbox.mjs         [####....................] 781.9 kB 8.1%
🟡 _chunks/frames-Dl2Hcma4.mjs [###.....................] 678.7 kB 7.0%
🟡 _chunks/oidc.mjs            [###.....................] 576.9 kB 5.9%
🔴 Other bundled files         [########################] 5.09 MB 52.5%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x",
  "maxDuration": "max",
  "experimentalTriggers": [
    {
      "type": "queue/v2beta",
      "topic": "__eve776561746865722d6167656e74_wkf_workflow_*",
      "consumer": "default",
      "retryAfterSeconds": 5,
      "initialDelaySeconds": 0
    }
  ],
  "environment": {
    "WORKFLOW_PRECONDITION_GUARD": "1"
  }
}

🟠 functions/__server.func • 15 public routes, 1 internal alias • 9.70 MB
Metric Value
Public routes /
/eve/v1/callback/[token]
/eve/v1/connections/[name]/callback/[attemptId]/[token]
/eve/v1/connections/[name]/callback/[token]
/eve/v1/health
/eve/v1/info
/eve/v1/session
/eve/v1/session/[parentSessionId]/subagents/[callId]/[childSessionId]/stream
/eve/v1/session/[sessionId]
/eve/v1/session/[sessionId]/cancel
/eve/v1/session/[sessionId]/clear
/eve/v1/session/[sessionId]/compact
/eve/v1/session/[sessionId]/reset
/eve/v1/session/[sessionId]/stream
/eve/v1/task-input/[token]
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 9.70 MB
Function files 9.70 MB across 133 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 1.59 MB (16.4%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                   [########................] 1.59 MB 16.4%
🟡 _libs/undici.mjs            [#####...................] 980.5 kB 10.1%
🟡 _chunks/sandbox.mjs         [####....................] 781.9 kB 8.1%
🟡 _chunks/frames-Dl2Hcma4.mjs [###.....................] 678.7 kB 7.0%
🟡 _chunks/oidc.mjs            [###.....................] 576.9 kB 5.9%
🔴 Other bundled files         [########################] 5.09 MB 52.5%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x"
}

Build Timing: e2e/fixtures/agent-tools-sandbox

This is an informational timing measurement inside eve build, from preflight through publication. Output-size measurement and profile writing are excluded.

Build mode: deployable Vercel build with sandbox template prewarm included.

  • Build pipeline: 1.49 s -> 4.49 s (+3.00 s) vs main (eb35ba7).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (eb35ba7)`
Phase Baseline Current Delta
extension.check 9.2 ms 0.7 ms -8.5 ms
project.resolve 0.3 ms 0.2 ms -0.1 ms
workspace.create 0.5 ms 0.4 ms -0.1 ms
host.prepare 194.9 ms 1.18 s +982.6 ms
vercel.service-prefix.resolve 1.0 ms 0.9 ms -0.1 ms
nitro.create 139.0 ms 144.4 ms +5.4 ms
sandbox.prewarm 243.7 ms 1.85 s +1.60 s
nitro.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.prepare 0.5 ms 0.5 ms 0.0 ms
nitro.public-assets 0.4 ms 0.5 ms +0.1 ms
nitro.prerender 0.3 ms 0.3 ms 0.0 ms
nitro.bundle 848.1 ms 1.25 s +405.7 ms
nitro.cache.write 0.2 ms 0.2 ms 0.0 ms
vercel.workflow-function.materialize 43.5 ms 54.9 ms +11.4 ms
agent-summary.emit 0.4 ms 0.4 ms 0.0 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 3.3 ms 3.9 ms +0.6 ms
workspace.remove 1.2 ms 1.3 ms +0.1 ms

@AndrewBarba
AndrewBarba marked this pull request as ready for review August 22, 2026 04:26
@AndrewBarba
AndrewBarba force-pushed the barba/source-neutral-module-bindings branch from 59c2284 to da6c78e Compare August 22, 2026 14:23
@AndrewBarba
AndrewBarba force-pushed the barba/programmatic-agent-sources branch from 3321534 to 7ad5939 Compare August 22, 2026 14:23
@AndrewBarba
AndrewBarba force-pushed the barba/programmatic-agent-sources branch from 7ad5939 to 1182ce1 Compare August 24, 2026 16:47
Base automatically changed from barba/programmatic-agent-sources to main August 24, 2026 16:49
@AndrewBarba
AndrewBarba force-pushed the barba/source-neutral-module-bindings branch from da6c78e to 1e741ec Compare August 24, 2026 16:52
@AndrewBarba AndrewBarba changed the title feat(eve): make compiled module bindings explicit feat(eve): agent sources - establish the canonical source graph Aug 24, 2026
Signed-off-by: Andrew Barba <barba@hey.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants